﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="File | Connect to Remote Session"/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>File | Connect to Remote Session</title>

<meta name="MS-HAID" content="r36_gui_1_f146f153-cacc-4f29-b493-b0d52b562060.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(2854);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/file___connect_to_remote_session.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="file___open_crash_dump.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="file___connect_to_remote_stub.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="windbg_graphical_interface_features.htm">WinDbg Graphical Interface Features</A> &gt; <A href="file_menu.htm">File Menu</A> &gt; </div>
	<div id="winchm_template_title">File | Connect to Remote Session</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>Click <b>Connect to Remote Session</b> on the <b>File</b> menu to make WinDbg a debugging client and to connect to an active debugging server.</p>
<p>This command is equivalent to pressing CTRL+R. You can use this command only when WinDbg is in dormant mode.</p>
<p>You cannot use this command to connect to a process server or a KD connection server; for that purpose, use <a href="#Bookmark2855">File | Connect to Remote Stub</a> instead.</p>
<h3><a id="connect_to_remote_debugger_session_dialog_box"></a><a id="CONNECT_TO_REMOTE_DEBUGGER_SESSION_DIALOG_BOX"></a>Connect to Remote Debugger Session Dialog Box</h3>
<p>When you click <b>Connect to Remote Session</b>, the <b>Connect to Remote Debugger Session </b>dialog box appears. You can use this dialog box to enter the remote connection parameters or to browse a list of debugging servers.</p>
<p>To manually specify the remote connection parameters, enter one of the following strings in the <b>Connection string</b> box:</p>
<pre class="syntax" xml:space="preserve"><code>npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6]

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6]

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password]

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]</code></pre>
<p>The various parameters in the preceding options have the following possible values:</p>
<p></p>
<dl>
<dt><a id="Server"></a><a id="server"></a><a id="SERVER"></a><i>Server</i></dt>
<dd>
<p>The network name of the computer on which the debugging server was created. Do <u>not</u> precede this name with backslashes (<b>\\</b>).</p>
</dd>
<dt><a id="PipeName"></a><a id="pipename"></a><a id="PIPENAME"></a><i>PipeName</i></dt>
<dd>
<p>If you use the NPIPE or SPIPE protocol, <i>PipeName</i> is the name that was given to the pipe when the server was created.</p>
</dd>
<dt><a id="Socket"></a><a id="socket"></a><a id="SOCKET"></a><i>Socket</i></dt>
<dd>
<p>If you use the TCP or SSL protocol, <i>Socket</i> is the same socket port number that was used when the server was created.</p>
</dd>
<dt><a id="COMPort"></a><a id="comport"></a><a id="COMPORT"></a><i>COMPort</i></dt>
<dd>
<p>If you use the COM protocol, <i>COMPort</i> specifies the COM port to use. The "COM" prefix is optional (for example, both "com2" and "2" are correct).</p>
</dd>
<dt><a id="BaudRate"></a><a id="baudrate"></a><a id="BAUDRATE"></a><i>BaudRate</i></dt>
<dd>
<p>If you use the COM protocol, <i>BaudRate</i> should match the baud rate that you chose when the server was created.</p>
</dd>
<dt><a id="COMChannel"></a><a id="comchannel"></a><a id="COMCHANNEL"></a><i>COMChannel</i></dt>
<dd>
<p>If you use the COM protocol, <i>COMChannel</i> should match the channel number that you chose when the server was created. </p>
</dd>
<dt><a id="Protocol"></a><a id="protocol"></a><a id="PROTOCOL"></a><i>Protocol</i></dt>
<dd>
<p>(Windows 2000 and later)  If you use the SSL or SPIPE protocol, <i>Protocol</i> should match the secure protocol that you used when the server was created.</p>
</dd>
<dt><a id="Cert"></a><a id="cert"></a><a id="CERT"></a><i>Cert</i></dt>
<dd>
<p>(Windows 2000 and later)  If you use the SSL or SPIPE protocol, you should use the identical <b>certuser=</b><i>Cert</i> or <b>machuser=</b><i>Cert</i> parameter that was used when the server was created.</p>
</dd>
<dt><a id="clicon"></a><a id="CLICON"></a><b>clicon</b></dt>
<dd>
<p>Specifies that the debugging server will try to connect to the client through a reverse connection. The client must use <b>clicon</b> if and only if the server is using <b>clicon</b>. In most cases, the debugging client is started before the debugging server when a reverse connection is used.</p>
</dd>
<dt><a id="Password"></a><a id="password"></a><a id="PASSWORD"></a><i>Password</i></dt>
<dd>
<p>If you used a password when the server was created, you must supply <i>Password</i> to create the debugging client. This value must match the original password. Passwords are case-sensitive. If the wrong password is supplied, the error message will specify "Error 0x80004005".</p>
</dd>
<dt><a id="ipversion_6"></a><a id="IPVERSION_6"></a><b>ipversion=6</b></dt>
<dd>
<p>(Debugging Tools for Windows 6.6.07 and earlier only) Forces the debugger to use IP version 6 rather than version 4 when you are using TCP to connect to the Internet.  In Windows Vista and later versions, the debugger attempts to auto-default to IP version 6, making this option unnecessary.  </p>
</dd>
</dl>
<p>Instead of manually specifying the remote connection parameters, you can press the <b>Browse</b> button in the <b>Connect to Remote Debugger Session </b>dialog box and use the <b>Browse Remote Servers</b> dialog box.</p>
<h3><a id="browse_remote_servers_dialog_box"></a><a id="BROWSE_REMOTE_SERVERS_DIALOG_BOX"></a>Browse Remote Servers Dialog Box</h3>
<p>In the <b>Browse Remote Servers</b> dialog box, in the <b>Machine</b> text box, enter the name of the computer that the debugging server is running on. (The two initial backslashes are optional: "MyBox" and "\\MyBox" are both correct.) Then, press the <b>Refresh</b> button.  </p>
<p>The <b>Servers </b>area lists all of the debugging servers that are running on that computer. Select any of the listed servers and then press ENTER or click <b>OK</b>. (You can also double-click one of the listed servers.) The proper connection string for the debugging server that you selected will now appear in the <b>Connection string</b> box in the <b>Connect to Remote Debugger Session</b> dialog box.</p>
<p>If the server is password-protected, the connection string includes <b>Password=*</b>. You must replace the asterisk (<b>*</b>) with the actual password.</p>
<p>After you specify the server and password, click <b>OK</b> to open the connection.</p>
<p>This list of servers in the <b>Browse Remote Servers </b>dialog box can also include servers that no longer exist but were shut down improperly. If you connect to one of these nonexistent servers, you will receive an error message. </p>
<p>The list of servers does not include process servers and KD connection servers; you can list those servers only by using the <a href="#Bookmark2855">File | Connect to Remote Stub</a> command or by running <b>cdb -QR </b><i>Server</i> from a Command Prompt window.</p>
<h3><a id="additional_information"></a><a id="ADDITIONAL_INFORMATION"></a>Additional Information</h3>
<p>For more information and for other methods of joining a remote debugging session, see <a href="#Bookmark1309"><b>Activating a Debugging Client</b></a>.</p></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
